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• The GIMANAL Program 

The GIMANAL program analysis a GIM data base to determine if 
the records are chained together properly and optionally to 
determine if items have proper character counts. The errors 
detected by the GIMANAL program are normally caused by a 
hardware or software error, followed by some failure in the 
recovery process that is used after all hardware or software 
failures. 

As the data base is being analyzed for errors, an option 
exists to generate a DDUMP tape for. the data base.* The 
DBUMP tape is the same format that is generated by a GIM 
DDUMP PHYSICAL verb and thus may be used as input to" the GIM 
RESTORE PHYSICAL verb or the batch GIM restore program. 

The input . files for the GIMANAL program are the DD cards 
that describe the GIM data base. Each extent reauires a DD 
card with the DDNAME of GIMDBOl for the first extent, 
GIMDE02 for the second and so on. The only DCB information 
required is DC3= (BUFNO20 ,OPTCT=C) . This causes the program 
to , use channel chaining to read the data base and thus 
reduces elasped time. The number of buffers (EUFKO) may be 
varied. The optimal number is a function of the hardware 
configuration and device characteristics. 

Two output files are possible with the GIMANAL proaram. The 
DDNAME of SYSPRINT is used to create a listing with all 
error messages, boot— strap parameters, data set names of the 
oata base, elasped time and a summary of error messages 
generated. A maximum of 50 error messages of each type will 
be printed so that, if a large number appear, the summary 
count on the last page of the listing should be checked for 
.. the total number. . y yy 

The DDNAME of DDUMP is used if a DDUMP PHYSICAL of the data 
base is desired. The program checks for the presence of a 
DDNAME equal to DDU^lP to see if a ddump is recruested. The 
DCB parameters, (RECFM=VB, LRECL=703 ,BLKSIZE=294 8 , ) are 

coded into the program and thus are not needed on the DD 
statement . 


* We do not use this option, and we are not really sure that it functions 
corrtectly® i % • * 
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■The JCL to run GIMANAL is: 


//ANAL JOB JOF-C ARP-ACCOUNT IN G- INFORMATION 
//J.OOLIS OD O SN-G I f-‘2, L CAO , 0 I SP = SHR 

' BM 

,/G,MM ° l 00 ocbmbJ^^o?S;^c f 330 • VCL * SER -*‘ 2 ^^ o «^^ 

0SN = PAY^rLt..FO02 , UNIT =3330 ,VGL = S ER= 123456 , 0 I SP-SHP " 
Of B =( ^ IJF NO = 20 » OP f C 0=C ) . S HP * 


// 

//GI MOB 02 
// 

//** 

/ /«* 

// ** 
//00U M P 

ft 


DO 


A DD CARD IS NE50FD FOR EACH EXTENT OF THE 


DATA BASE 


«'|.TOj»™ ,,0,ri ' S '" N "’ K - F ' 1,USEUI I.SL.REtpd.OISJ, 


Region Size 


The region size of the job is a function of the size of thp 
cverflow ar e a (one bit per record) and the nunber of buffers 
specified on the .GIKDBxx DD cards. A regions size of 12 CK 

dat 2 5 ase With 16 ■ 000 overflow 6 ?ecordS 
nrrrn “ C N and EUF:; °= 2 °- Decreasing or increasing 

buffer ?hul f$ a B SS° n EiZS by 2bOUt 700 byt6S for eac ^ 
ourter. i hus if BUFhO was increased by 30 to 50 reason 

size would be increased by 22K to - 142K. ' ^ 
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Completion Code 


The. GIMANAL program sets a completion code so that a 
positive check can be made in the JCL for the results of the 
analysis. Possible ■ completion codes from GIMANAL are: 


Completion code 

0 

A 

8 

12 

DBSTATS Option 


Meaning 

Program terminated due to abnormal 
errors by PLI error recovery 
such as I/O error on tape or disk. 

Program terminated normally and no 
errors detected 

Program terminated normally but 
detected some unchained overflow 
records (GAO 15 message) . 

Program terminated normally but 
detected errors with data base. 
(Any message other than GA015) 


To cause GINANAL. to perform character count checking in 

f' v^i tXCn T to c y ec - lcin< I chains, include PARM= '/DBSTATS 1 on the 
EXEC care. This should be done any time there is a Question 
concerning the physical integerity ■ of the data base and 
regularly scheduled based on update activity. This option 

tiV t JPP r0xir * a tely one to two minutes 
of CPU on a 65 for each -2314 pack. 

DDUMP Option 

To cause GIMANAL to generate a DDUMP PHYSICAL tape of the 

nnnMr> baSe ' & DD Card f ° r the tape with a DDNAME of 

DDUMP . • . DCB information (FLCFM=VB,LRECL=703 , BLKSI ZE=29 4 8 ) 

is coded into the program since the online GIM system has a 
maximum blocxsize of 3512. At the completion of ^he DDU'-'p a 

data a set Wlth ^ ’ data SSt name ±S ' printed on the SYSPRINT 
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■Error Messages ■ 

GIM Analysis program error messages are described in 
Appendix A. Phase one reads all records in the prime area 
and follows each group to the end of its chain. ~ For each 
overflow record, a bit is set to show that it has been used. 
If the bit was already set, then an error message is 
generated. Phase two reads all records in the free area 
(LOVJREC TO BOTTOM OF AVAILABLE SPACE) to make sure each 
record points to the preceding record. In phase three, the 
chain of available overflow’ records . (beginning with NEXT 
AVAILABLE OVERFLOV7) is followed until it chains to LOWREC . 
The bit map . of used overflow’ records is checked to make sure 
no record is used more than once. The last phase is to 
check the bit map of overflow records and list out anv 
overflow records that have not been used (GA015 message) . If 
this is the only error message, the data base most likely is 
in a useable condition. However , the error that caused 
overflow records to be lost should be found and corrected. 
The data base should be reallocated to reclaim the lost 
overflow records. 

Message numbers GAO 01 to GAO 04, shown with an *, are' only 
generated when the DBSTATS option is included to cause 
character count checking. 
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GAO 01 (*) 


GAO 02 (*) 


GAO 03 (*) 


GAO 04 (*) 


GAO 05 


GAO 06 


GA007 
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• APPENDIX A 

GIM Analysis Error Messages 

End of chain found before end of group mark 
was found. (A chain to zero was found, but 
end of group mark had not been seen.) Most 
likely, the last item i.n the group is 
incomplete. Analysis continues with the next 
group. 

Neither a five digit charcter count nor an 
end-of ygroup mark (°) was encountered 
following the last item processed. Character 
count checking for the group is terminated 
although the chain is followed to the end. 

End of group mark found in an overflow record 
that does not chain to zero. One or more 
overflow records are chained to the oroup but 
have no data. Analysis continues normally. 

An- item does not end with a record mark (°). 
Character count checking for the group is 
terminated although the chain is followed to 
the end. 

A record in the prime area chains to the 
bottom of available area from the record just 
before bottom of available. A files prime 
allocation has overflowed into the free area. 

A group uses the same overflow record more 
than once in the chain, thus causing an 
endless loop. A-nalysis continues with the 
next group. 

A group uses an overflow record which is also 
used by another group. (Two or more records 
point to the same overflow record.) Analysis 
(with character count checking) continues as 
long as it is valid. 


* 



* 
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'GA008 An overflow record in a chain, points to an 

invalid overflow record. (Overflow record 
must be between LOWREC and LASTREC) . Anlysis 
continues with the next group. 

GA009 A prime record chains to an invalid record. 

Must chain to either the next prime record or 
an overflow record. Analysis continues with 
the next group. 

GA010 The record at the bottom of available space 

does not chain to zero. It is the last 
record in the chain of free records and must 
_ . ’ chain to zero. Analysis continues with the 

" . chain of available overflow. 

GA011 A record in the free space area does not 

point to the record immediately preceding it. 
All free space records must be chained to the 
preceding record. Analysis of the free space 
continues. 

GAO 12 An overflow record, in the chain of available 

overflow records, points to an invalid 
overflow record. Analysis of the chain of 
available overflow is terminated. 

GAO 13 A record in the chain of available overflow 

records is pointed to more than once thus 
causing a loop. Analysis of the overflow 
chain is terminated. 

GA014 A record in the chain of available overflow 

records uses an overflow record which is also 
used by another group. (Two or more records 
point to the same overflow record.) Analysis 
continues of the overflow chain. 
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GA015 


GAO 16 


GA017 



GA018 


GA019 


GAO2 0 
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These overflow records do not appear in any 
valid group or the available overflow chain 
and thus are 'LOST' to GIM. (No record 
points to the record.) These messages are 
generated after all analysis is completed. 

A group has more than 50 bad records in a 
chain. Processing of the group is terminated 
and continues with the next group. 

This gives the number of records in the chain 
of available overflow records. These are 
overflow records that have been used and 
turned back to the overflow chain. If this is 
zero then overflow records are taken from the 
bottom of free space. 

This is the number of records in the prime 
area that have never been allocated to a GIM 
file. . 

This indicates the DDUMP data set name. The 
volume serial numbers may be obtained from 
the JCL. 

This message is associated with a previous 
error message (-GA€HH: ,GA0 02 ,GA003 or GA004) . 
It shows the first 20 characters of the last 
item seen by the program when the error was 
detected. It also gives the number of prime 
records, overflow records, and valid items, 
read by the analysis program for the group, 
before the error was found. 


* Message generated only when DESTATS option selected which 
activates character count checking. 
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